Developer Documentation

QuickTime 4 API Documentation

QuickTime 4 Reference

| Previous | Chapter Contents | Chapter Top | Next |

Sample Reference

The SampleReferenceRecord structure is used to describe information about a sample or group of similar samples. This data structure is used by the GetMediaSampleReferences and AddMediaSampleReferences functions.

struct SampleReferenceRecord {
    long        dataOffset;
    long        dataSize;
    TimeValue   durationPerSample;
    long        numberOfSamples;
    short       sampleFlags;
};
typedef struct SampleReferenceRecord SampleReferenceRecord;
typedef SampleReferenceRecord *SampleReferencePtr;

Field descriptions

dataOffset
Specifies the offset into the movie data file. This field specifies the offset into the file of the sample data.

dataSize
Specifies the total number of bytes of sample data identified by the reference. All samples referenced by a single SampleReferenceRecord must be the same size.

durationPerSample
Specifies the duration of each sample in the reference. You must specify this parameter in the media's time scale. All samples referenced by a single SampleReferenceRecord must be the same duration.

numberOfSamples
Specifies the number of samples contained in the reference.

sampleFlag
Contains flags that control the operation. The following flag is available (set unused flags to 0):

mediaSampleNotSync
Indicates whether the sample to be added is not a synchronous sample. Set this flag to 1 if the sample is not a synchronous sample. Set this flag to 0 if the sample is a synchronous sample.

© 1999 Apple Computer, Inc.

| Previous | Chapter Contents | Chapter Top | Next |